home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TA / (A)TAV.ADF / Q-Cat / QCAT.DOC < prev    next >
Text File  |  1988-12-29  |  3KB  |  94 lines
  1.  
  2.     11/88
  3.  
  4.  
  5.     QCAT v0.01 -- List files on disks or in directories
  6.  
  7.  
  8.                          -----------------
  9.  
  10.                    Copyright (C) 1988 by Daniel Elbaum
  11.  
  12.          This software is freely redistributable provided that:
  13.          the three files which comprise it (qcat, qcat.c, qcat.doc)
  14.          remain intact; all copyright notices contained in any of
  15.          the aforementioned files remain intact; and no fee beyond
  16.          reasonable remuneration for collation and distribution be
  17.          charged for use and/or purveyance.
  18.  
  19.                          -----------------
  20.  
  21.     Syntax:
  22.         qcat [-o filename] [dirname ...]
  23.     or
  24.         qcat [-o filename] -c drive
  25.  
  26.  
  27.     Qcat simply produces a listing of the full pathname of all
  28.     files in a list of directories or in a series of disks.
  29.  
  30.     With no arguments, a list is produced of the files in the
  31.     current directory and all its sub directories.
  32.  
  33.     -o redirects the list to a file of the specified name, wiping
  34.     out any file of that name which may already exist.
  35.  
  36.     -c causes a continuous listing of a single drive.  A requestor
  37.     comes up prompting for a disk to be inserted; the names of the
  38.     files on that disk are read, and the requestor comes back asking
  39.     for the next disk.  When all the disks you want to catalog have
  40.     been fed in, click on the 'Quit' gadget, and the complete file
  41.     list will be output.
  42.  
  43.     Instead of -c and a drive name, a bunch of directory names can
  44.     be given on the command line.  A single list will be output of
  45.     all the files in all the specified directories and their sub-
  46.     directories.
  47.  
  48.     Nota Bene:
  49.  
  50.     The list won't be sorted.  There are plenty of utilities out
  51.     there which sort files by line, so I didn't want to bloat
  52.     this program with the extra functionality.  If enough people
  53.     want a sorting option, I'll add one.
  54.  
  55.     If the directory trees to be listed are deep (lots of sub-
  56.     directories), the be sure to set the stack size to something
  57.     like 10000 or so, since the recursive routine that does the
  58.     spelunking is pretty stack-hungry.
  59.  
  60.     The purpose of qcat is to list disks or directories, given a
  61.     simple command line, without involving the user in an interactive
  62.     experience.  One good use for it is to make a listing for a set
  63.     of disks, then use the list to find out where particular files
  64.     are located.  Should come in handy for those Fish disks, eh?
  65.  
  66.     The way it works is to keep a linked list of filenames in memory
  67.     until all disks or directories have been read, and then to dump
  68.     the list.  If memory gets low, the list will be dumped several
  69.     times during the reading, so even if you have lots of disks to
  70.     look at or not much memory or both, qcat should function smoothly.
  71.  
  72.  
  73.     If you want to send me money for qcat, then by all means
  74.     do so--many projects are in progress and I need financing.
  75.     $5.00 is recommended.  Make checks payable to:
  76.  
  77.     Daniel Elbaum
  78.     Amaranth Software
  79.     4816 SE Bybee Blvd.
  80.     Portland, Ore. 97206
  81.  
  82.  
  83.     Send comments, suggestions, and flames to:
  84.  
  85.     Daniel Elbaum
  86.     Portland bbs: Amigaboard!, NAG, HABIT
  87.     UUCP: ...!tektronix!reed!elbaum
  88.     ARPA: elbaum@reed.EDU
  89.  
  90.  
  91.  
  92.  
  93.  
  94.